home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat2
/
ftn
/
sgikopt.z
/
sgikopt
Wrap
Text File
|
1998-10-30
|
8KB
|
199 lines
SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222)))) SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222))))
NNNNAAAAMMMMEEEE
sgikopt - retrieve kernel option strings
FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
iiiinnnntttteeeeggggeeeerrrr ****4444 ffffuuuunnnnccccttttiiiioooonnnn ssssggggiiiikkkkoooopppptttt ((((ooooppppttttiiiioooonnnn,,,, bbbbuuuuffff,,,, bbbbuuuufffflllleeeennnn))))
cccchhhhaaaarrrraaaacccctttteeeerrrr **** ((((****)))) ooooppppttttiiiioooonnnn
cccchhhhaaaarrrraaaacccctttteeeerrrr **** ((((****)))) bbbbuuuuffff
iiiinnnntttteeeeggggeeeerrrr ****4444 bbbbuuuufffflllleeeennnn
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
The IRIX kernel saves most of the IRIS PROM Monitor environment variables
(option strings) for later use by the kernel as well as user programs.
_s_g_i_k_o_p_t allows the user to retrieve the values of these variables. The
_o_p_t_i_o_n argument specifies the name of the variable; the value of the
option is returned in the buffer addressed by _b_u_f. The size in bytes of
this buffer is given by _b_u_f_l_e_n. The string returned by _s_g_i_k_o_p_t is
guaranteed to be null-terminated, even if the length of the option value
string exceeds _b_u_f_l_e_n.
The environment variables recognized by _s_g_i_k_o_p_t are as follows:
bootfile The name of the file to use for autobooting.
bootmode The type of boot performed: mmmm to enter the PROM Monitor
after clearing memory, dddd to enter the PROM Monitor without
clearing memory, or cccc to perform an autoboot using the
bootfile.
console The console to use: gggg for graphics console, GGGG for
graphics console with logo, or dddd for serial terminal port
1.
diskless If this variable is set, the system expects to mount it's
root filesystem via NFS from a server. It may be set even
if a local disk is installed, in which case the local root
disk is ignored.
dllogin When _d_i_s_k_l_e_s_s is set, this is the login name to use during
installation on a diskless machine. See _c_l__i_n_i_t(1m) for
more information.
dlserver When _d_i_s_k_l_e_s_s is set, this is the hostname of the machine
from which the root filesystem will be mounted. It should
be set in standard IP address format.
gfx An variable indicating if graphics state: aaaalllliiiivvvveeee or ddddeeeeaaaadddd....
hostname The Internet host name string.
PPPPaaaaggggeeee 1111
SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222)))) SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222))))
initfile The process control initialization program if the default,
/_e_t_c/_i_n_i_t, is overridden. See _i_n_i_t(1M).
initstate The run level to override the default state present in
/_e_t_c/_i_n_i_t_t_a_b. See _i_n_i_t_t_a_b(4).
keybd The international keyboard type.
monitor Overrides the default monitor setting when an unrecognized
monitor is attached to an Indy system. Specifying 'h' or
'H' indicates the attached monitor supports high
resolution mode (1280x1024 @ 60Hz). Otherwise the default
resolution is low resolution (1024x768 @ 60Hz). This
variable is usable only on an Indy system and is stored in
non-volatile RAM.
netaddr The Internet network address for booting across the
Ethernet.
logocolor The color of the logo while in the standalone programs,
and the kernel textport (no window manager running) is
controlled by this variable. It is 6 hex digits, which
are the values for red, green, and blue in that order.
This is currently implemented only on the Personal Iris.
nswap The number of blocks to use in the swap partition; this
amount overrides the partition size.
pagecolor The color of the textport while in the standalone
programs, and the kernel textport (no window manager
running) is controlled by this variable. It is 6 hex
digits, which are the values for red, green, and blue in
that order. This is currently implemented only on the
Personal Iris.
root The disk that contains the root (/) file system (as it
would be named in the /dev/dsk directory).
screencolor The color of the screen background while in the standalone
programs, and the kernel textport (no window manager
running) is controlled by this variable. It is 6 hex
digits, which are the values for red, green, and blue in
that order. This is currently implemented only on the
Personal Iris.
showconfig If this variable is specified, the kernel will print out
verbose information about memory and device configuration
at boottime.
srvaddr If set, this specifies the (only) host that will be used
to resolve bootp requests. It should be set in standard
IP address format.
PPPPaaaaggggeeee 2222
SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222)))) SSSSGGGGIIIIKKKKOOOOPPPPTTTT((((2222))))
swaplo The first block to use in the swap partition; this amount
overrides the default value of 0.
sync_on_green If this value is nnnn, the sync information is not
superimposed on the green monitor line.
tapedevice The tape device used for software installation.
DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
Upon successful completion, _s_g_i_k_o_p_t returns 0. Otherwise, _s_g_i_k_o_p_t
returns -1 and sets _e_r_r_n_o to indicate the error:
[EINVAL] The given _o_p_t_i_o_n was not found.
[EFAULT] The _o_p_t_i_o_n or _b_u_f argument specifies an invalid address.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
syssgi(2) - the SSSSGGGGIIII____GGGGEEEETTTTNNNNVVVVRRRRAAAAMMMM command provides almost the same
functionality.
PPPPaaaaggggeeee 3333